home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr30 / scr210a.zip / SNAPSHOT.DOC < prev   
Text File  |  1993-01-23  |  5KB  |  128 lines
  1. SNAPSHOT.DOC  -06/13/85-
  2. SNAPSHOT - program to store/display a screen & display up to 3 disk-stored
  3.        screens. Appeared in PC Magazine, 7/9/85 issue, p. 183
  4.  
  5. Program author:  Steve Holzner
  6. This documentation: P. L. Olympia, Sysop, SMUG RBBS 301-963-5249
  7.  
  8. FILES IN THIS PACKAGE
  9.  
  10.      SNAPSHOT.ASM  - typed in by John Petrocelli.  Thanks, John. I added 
  11.                      a few comments to help with customization
  12.      SNAPSHOT.COM  - compiled program with all defaults described in the 
  13.                      PC Magazine article
  14.      SCANCODE.BAS  - Program listed by Steve Holzner to display  scan 
  15.                      codes associated with keys (LSB first)
  16.      SNAPSHOT.DOC  - This one you are reading
  17.  
  18. WHAT IT DOES
  19.  
  20.      SNAPSHOT  stores the currently displayed screen (via CTRL-N)  which 
  21.      can  be displayed at a later time (via CTRL-F) from within  DOS  or 
  22.      any application program.   In addition,  it can also display to the 
  23.      screen  any one of three files on the current directory with  names 
  24.      A.DAT, B.DAT, C.DAT (via CTRL-A, CTRL-B, CTRL-C, respectively).
  25.  
  26.  
  27. HOW TO USE
  28.  
  29.      At the DOS prompt, type: SNAPSHOT
  30.  
  31.      The  program  becomes memory resident and occupies about  10K  of 
  32.      memory (because of the space for stored screens).  Alternatively, 
  33.      you may wish to add the line:
  34.  
  35.           SNAPSHOT
  36.  
  37.      in your AUTOEXEC.BAT file.
  38.  
  39.      
  40.      To  store the currently displayed screen,  press ^N (CTRL-N).  To 
  41.      display that screen back at any time,  press ^F;  then press  any 
  42.      key to return to the interrupted program. 
  43.  
  44.      If you have A.DAT,  B.DAT, C.DAT stored on the current directory, 
  45.      you  may  display them  with  ^A,^B,^C,  respectively.  Again,  a 
  46.      keypress  after  the  display  returns  you  to  the  interrupted 
  47.      program.
  48.  
  49.      The DAT files must not be larger than one screenful (2000 bytes). 
  50.      If you want to be able to read WordStar files written in document 
  51.      mode,  you  may  customize SNAPSHOT to strip the  high  bit  (set 
  52.      WS_FLAG  to  1).  But  doing  so will not allow  you  to  display 
  53.      properly  those  screens containing the IBM extended  ASCII  char 
  54.      set.
  55.  
  56.  
  57. SAMPLE APPLICATIONS
  58.  
  59.      I  use this program to store and flash application help screens and 
  60.      table codes from many applications such as dBASE III.  There are  a 
  61.      host of other uses for this program. Be imaginative.
  62.  
  63.  
  64. LIMITATIONS
  65.  
  66.      Program uses interrupt 9 and will conflict with programs that take
  67.      control of the keyboard.  The program does not work under Multilink 
  68.      ver 2.06 without some adjustments.
  69.  
  70.      Some  of the default keys used to store and flash screens  conflict 
  71.      with many programs, such as WordStar. You may want to change these.
  72.      See below for customization notes.
  73.  
  74.  
  75. CUSTOMIZATION NOTES
  76.  
  77.      Most customizable parameters are documented in the ASM file. Just 
  78.      change those and recompile.   If you don't have ASM or MASM,  use 
  79.      DEBUG to make the changes.  The locations of the commonly changed 
  80.      parameters are:
  81.  
  82.        ADDRESS      DEFAULT CONTENT
  83.  
  84.        116,117      0E,31  (^N)
  85.        118,119      06,21  (^F)
  86.        11A,11B      01,1E  (^A)
  87.        11C,11D      02,30  (^B)
  88.        11E,11F      03,2E  (^C)
  89.        12D-131      A.DAT
  90.  
  91.      If  you don't know the scan codes associated with some keys you'd 
  92.      rather use, run the program SCANCODE.BAS
  93.  
  94.           BASICA SCANCODE
  95.  
  96.      Press the key you want and record the two bytes that show on  the 
  97.      screen.  Continue  this process for other keys.  End the  program 
  98.      with CTRL-BREAK, then give the BASIC command: SYSTEM
  99.  
  100.  
  101. SUGGESTION
  102.  
  103.      I would like to suggest to the Public Domain community to write a 
  104.      small  documentation file like this for any program derived  from 
  105.      magazines that you type.   Include references to the source,  the 
  106.      source  program  and  other auxilliary  programs.   If  you  just 
  107.      transmit the COM file,  you're not helping novices who need  your 
  108.      help  the  most.   Also,  most  people  would  want  to  do  some 
  109.      customization to resolve program conflicts.
  110.  
  111.      PC  Magazine  runs an interactive reader service BBS at  212-696-
  112.      0360   which  apparently  contains  the  programs  it   regularly 
  113.      publishes.  I understand that it is as busy as hell (understandly 
  114.      so) and that PC Magazine is planning on adding more lines. In the 
  115.      meantime,  if  you ever get on and get some files,  send them  to 
  116.      your  favorite BBS.  If you don't have the time to write the  DOC 
  117.      for it,  send it to my BBS at 301-963-5249 (Rockville,  MD) and I 
  118.      will do it for you,  then release the program as an LBR  file.  I 
  119.      need the source program (ASM).  The COM file or the BAS file that 
  120.      generates the COM file is not going to do any of us any good.
  121.  
  122.      Finally,  I  would  like to start an LBR file containing  UTILITY 
  123.      programs like SNAPSHOT from PC Magazine and others. Contributions 
  124.      of  programs  are welcome or you can do it yourself and  pass  it 
  125.      around.
  126.  
  127.      Happy BBSing ...
  128.